home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / ALOWELE.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  52 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _ALowElement( axArray ) --> nLowElement
  8.  
  9. PARAMETERS:
  10.  
  11. axArray : array of CHAR, DATE, or NUM elements
  12.  
  13. SHORT:
  14.  
  15. Get the element number of the lowest value in an array of char, num, or date.
  16.  
  17. DESCRIPTION:
  18.  
  19. _ALowElement() returns the element number associated with the lowest
  20. value from an array of Character Strings, Dates or Numerics.
  21.  
  22. ALL elements must be of the same type! If the array contains mixed elements,
  23. a run-time error will occur.
  24.  
  25. If the array in not CHAR, DATE, or NUM, the return value is NIL.
  26.  
  27. NOTE:
  28.  
  29. See also:
  30.  
  31. _AHighVal() which returns the highest value.
  32.  
  33. _ALowVal() which returns the lowest value.
  34.  
  35. _AHighElement() which returns the element number associated with the
  36. highest value.
  37.  
  38. EXAMPLE:
  39.  
  40. LOCAL aArray := { 1,5,3,9,12,7 }
  41. t = _ALowElement( aArray )
  42.  
  43. Result: t = 1
  44.  
  45.  
  46. LOCAL aArray := { 'Wallace', 'Jones', 'Taylor', 'Abdul'  }
  47. t = _ALowElement( aArray )
  48.  
  49. Result: t = 4
  50.  
  51. ******************************************************************************/
  52.